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PREFACE 



This manual provides an overview of the System 86/330A Microcomputer 
System, a high-performance system that combines Intel board products, state- 
of-the-art peripherals, the iRMX 86 Operating System, Intel language products, 
and debugging and diagnostic tools into a single package. The first five chapters of 
this manual provide general information which will be of particular interest to 
readers who are unfamiliar with Intel hardware and software products. The sixth 
chapter provides detailed information about the System 86/330A software; this in- 
formation is intended for users who are familiar with the iRMX 86 Operating 
system but who have not used the System 86/330A Microcomputer System. 

Product Safety Standards 

The System 86/330A Microcomputer System is listed under UL standard 478 
(Safety of Electronic Data Processing Units and Systems). It is also certified by the 
Canadian Standards Association, standard C22.2 154-1975 (Safety of Data Pro- 
cessing Equipment). The system complies with the International Electrotechnical 
Commission standard IEC 435 (Safety of Data Processing Equipment). The 
system also conforms to the applicable Class A RFI/EMI requirements of VDE 
0871/6.78, VDE 0875/6.77 and FCC rule 47 CFR, part 15, subpart J (Emission 
Limits for Class A Computing Devices) . 

However, the System 86/330A Microcomputer System generates, uses, and radi- 
ates radio frequency energy. Interference to radio communications (RFI) may 
result if the equipment is not installed and operated in accordance with the proce- 
dures in the SYSTEM 86/330A INSTALLATION AND MAINTENANCE 
MANUAL. The equipment was tested for compliance and complies with the limits 
for a Class A computing Device pursuant to Subpart J of Part 15 of FCC rules de- 
signed to provide reasonable protection against interference (RFI) for operation in 
a commercial environment. If the equipment is operated in a residential area, 
users are responsible, at their own expense, to take whatever measures are re- 
quired to correct the likely occurrence of an unacceptable level of interference 
(RFI). 



Notational Conventions 

This manual contains several examples of user dialog at a terminal. Throughout 
this manual, user input is underscored to distinguish it from system output. 

Related Publications 

The following manuals provide additional information that may be helpful to users 
of this manual. Chapter 5 contains a short description of each of the manuals. 



Manual Number 

System 86/330A Installation and Maintenance Manual 144777 

System 86/300 Series Diagnostic Maintenance Manual 144813 

Introduction to the iRMX™ 86 Operating System 9803124 
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Manual 



Number 



iRMX™ 86 Nucleus Reference Manual 9803122 

iRMX™ 86 Terminal Handler Reference Manual 143324 

iRMX™ 86 Debugger Reference Manual 143323 

iRMX™ 86 Basic I/O System Reference Manual 9803123 

iRMX™ 86 Extended I/O System Reference Manual 143308 

iRMX™ 86 Loader Reference Manual 143318 

iRMX™ 86 Human Interface Reference Manual 9803202 

iRMX™ 86 Disk Verification Utility Reference Manual 144133 

iRMX™ 86 System Programmer's Reference Manual 142721 

iRMX™ 86 Programming Techniques Manual 142982 

Guide to Writing Device Drivers for the iRMX™ 86 and 

iRMX™ 88 I/O Systems 142926 

iRMX™ 86 Configuration Guide 9803126 

iRMX™ 86 Installation Guide 9803125 

EDIT Reference Manual 143587 

ASM86 Macro Assembly Language Reference Manual 121627 

ASM86 Macro Assembler Operating Instructions for 

8086-Based Development Systems 121628 

PL/M-86 User's Guide 121636 

iAPX 86, 88 Family Utilities User's Guide 121616 

Run-Time Support Manual for iAPX 86, 88 Applications 121776 

8087 Support Library Reference Manual 121725 

User's Guide for the iSBC® 957B iAPX 86, 88 Interface and 

Execution Package 143979 

iRMX™ 86 System Debug Monitor Reference Manual 143908 

iSBC®016A/032A/064A/028A/056A RAM Board Hardware 

Reference Manual 143572 

iSBC®215 Winchester Disk Controller Hardware 

Reference Manual 121593 

iSBX™ 218 Flexible Disk Controller Hardware Reference Manual 121583 
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Manual 



Number 



iSBC® 86/14 and iSBC® 86/30 Single Board Computer 
Hardware Reference Manual 

iSBC®337 Multimodule™ Numeric Data Processor Hardware 
Reference Manual 

iSBC® 680/68 1 Multistore User System Package Hardware 
Reference Manual 



144044 

142887 
162432 



The System 86/330A Overview Manual includes a fold-out chart of the System 
86/330A manual set. This chart should help you determine which manuals to read 
and in which order you should read them. Chapter 5 contains detailed descriptions 
of each of the manuals included with your System 86/330A Microcomputer 
System. 
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CHAPTER 1 
INTRODUCTION 



The System 86/330A Microcomputer System is a comprehensive hardware and 
software package designed to solve sophisticated 16-bit OEM computational prob- 
lems (see Figure 1-1). When configured with your software products, it becomes a 
cost-effective execution system. When connected to a standard RS232-compatible 
terminal which you provide, the System 86/330A can be used to develop software 
for Intel's iRMX 86 board-based systems. 




Figure 1-1. System 86/330 A Microcomputer System 



The System 86/330A has a number of features that are important to OEMs: 

• Configurable hardware consisting of standard Intel boards and chassis. 

• Configurable, multitasking operating system designed for current and future 
Intel VLSI. 

• Support for multiprocessing and coprocessors. 

• Dual-purpose software environment (iRMX 86 program development and 
program execution). 

• Available optional support packages. 

• Available product service and technical support. 
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Introduction System 86/330A 



This chapter discusses each of these features. It also discusses the contents of the 
remainder of this manual. 



Standard Intel Hardware 

The System 86/330A Microcomputer System contains an Intel chassis, processor 
board, memory board, and disk controller board. All of these products are availa- 
ble individually from Intel. This provides two important benefits for you. First, be- 
cause the application software you develop to run on your System 86/330A Micro- 
computer System runs on a system made up of standard parts, it will also run on 
Intel single board computer products that you purchase separately. Thus, you can 
build your first systems using the entire System 86/330A Microcomputer System 
and later build more-specialized products using individual single board computer 
products. 

Second, because the system is made up of modular parts, you can easily upgrade 
your system when new, more-advanced Intel boards become available. You can 
also customize your System 86/330A Microcomputer System by adding other Mul- 
tibus system bus boards which are available from Intel. 

Configurable, Multitasking Operating System 

The iRMX 86 Operating System available with the System 86/330A Microcomput- 
er System complements the configurable nature of the System 86/330A hardware. 
It is a multitasking operating system, making it very effective for real-time 
applications. It is also configurable, allowing you to change the operating system to 
support new or additional hardware. With this configurable operating system, you 
can decrease your memory requirements by excluding parts of the operating 
system for which you have no use. You can also provide new or additional software 
features by extending the operating system. 



Support For Multiprocessing 

The configurable nature of the System 86/330A hardware and software allows the 
System 86/330A Microcomputer System to support a multiprocessing 
environment. Because the hardware is configurable, you can add additional Intel 
processor boards to the system. Because the software is configurable, you can add 
Intel's Multibus Message Exchange software to allow a processor board to commu- 
nicate with other processor boards via the Multibus interface. This enables you to 
increase the general-purpose processing power of the System 86/330A 
Microcomputer System by adding boards such as the iSBC 86/05 8mhz 
8086-based processor board and the iSBC 88/25 8088-based processor board. To 
add special-purpose processing power, you can also add intelligent, 
high-performance, microprocessor-based boards such as the iSBC 550 Ethernet 
communications controller (Ethernet is trademark of Xerox Corporation), the 
iSBC 544 serial communications controller, and the iSBC 88/40 analog 
measurement and control computer. 

Dual-Purpose Software Environment 

The System 86/330A Microcomputer System is a versatile and powerful vehicle 
for iRMX 86 program execution. However, unlike previous microcomputer 
systems, the System 86/330A Microcomputer System can also be used for iRMX 
86 program development. The system contains a set of standard Intel language 
products which you can use to develop iRMX 86 application software and which 
you can include in your end product. 
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Optional Support Packages 

Intel offers optional support packages called extension modules that you can use 
to expand your hardware and software capabilities. One of the extension modules 
is called iSMX 100 Xenix extension module (Xenix is a trademark of Microsoft, 
Inc.). The iSMX 100 Xenix extension module allows you to run the Xenix Operat- 
ing System (a fully licensed version of Bell Laboratories UNIX Version 7), with 
multiple terminals; therefore, it transforms your System 86/330A Microcomputer 
System into a System 86/330X Microcomputer System. Contact your local Intel 
sales representative or distributer for more information about the extension 
modules that are available. 

Service and Support 

Intel offers several maintenance-support options that you can tailor to your needs. 
These options include a board-exchange program and on-site service (within areas 
serviced by Intel). Technical support is also available through qualified Field Ap- 
plication Engineers in Intel field offices. Contact your local Intel sales representa- 
tive or distributor for more information. 

About the Rest of This Manual 

The remaining chapters of this manual provide an overview of the software and 
hardware available with the System 86/330A Microcomputer System. These chap- 
ters are divided into two categories: general overview material intended for all 
readers and specific software information intended for readers who are already fa- 
miliar with the iRMX 86 Human Interface. 

Chapters 2 through 5 provide general material which you can read to get a feel for 
the kinds of hardware, software, and manuals which are available with the System 
86/330A Microcomputer System. 

» Chapter 2 provides an overview of the system hardware. It identifies each ele- 
ment of the system and points to other manuals where you can find more- 
detailed information. 

• Chapter 3 provides an overview of the system software. It introduces you to 
the iRMX 86 Operating System and discusses each of the other software 
components. This chapter also refers you to other manuals for more-specific 
information. 

• Chapter 4 contains a sample program development session. You can follow 
the instructions in this chapter to create a working PL/M-86 program. 

• Chapter 5 contains an overview of the manuals available with the System 
86/330A Microcomputer System. It lists the manuals and provides a one- 
paragraph description of each manual. 

Chapter 6 provides detailed software information about the System 86/330A Mi- 
crocomputer System. In particular, it discusses the use of the preconfigured ver- 
sion of the iRMX 86 Operating System, a runnable version of the operating 
system that is already configured for the System 86/330A environment. This infor- 
mation is important for users who are familiar with the iRMX 86 Human Interface 
and who want to know how to communicate with the System 86/330A Micro- 
computer System via the Human Interface. 
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CHAPTER 2 
HARDWARE OVERVIEW 



The System 86/330A hardware consists of a chassis which contains a six-slot Mul- 
tibus card cage, a switching power supply, a processor board, an intelligent disk 
controller board, a memory board, a 35M byte, 8-inch Winchester drive, and a 1M 
byte, 8-inch flexible disk drive. This chapter discusses each of these hardware 
elements. 



WARNING 



1 



Chassis 



Hazardous voltage and current levels are 
present within this system. To avoid risks 
of electric shock or fire, only qualified 
technical persons should remove the top 
cover of the System 86/330A Micro- 
computer System. 



The chassis, Figure 2-1, is designed such that access for servicing the unit is both 
easy and convenient. The top cover is attached by four quarter-turn fasteners. The 
rear panel securing the power supply is attached with six screws. The front panel 
and both side panels are attached with ball-stud fasteners. The bottom cover is at- 
tached with four screws. 

Mounted onto the front of the chassis is an illuminated power switch located at the 
lower right corner and a front panel with two pushbutton switches and two 
indicators. 

The rear panel of the chassis supports I/O connectors whose functions are as 
follows: 



Connector 

Jl 
J2 



Function 

RS232 serial I/O port for a CRT/Keyboard. 

A 50-pin parallel I/O communications port that is sup- 
plied with signal levels which are compatible with the 
industry-standard Centronics printer interface. 



J3 
J4 



Connector for additional Winchester drives. 
Connector for additional flexible disk drives. 



Refer to the iSBC 680/681 USER SYSTEM PACKAGE HARDWARE REFER- 
ENCE MANUAL for additional information about the chassis. 
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System 86/330A 



SWITCHING POWER 
SUPPLY WITH 
FAN HOUSING 



(2) ISBX'" EXPANSION 
BUS CONNECTORS 



35MB 8' 
WINCHESTER 
DISK DRIVE 



1MB 8" DOUBLE-SIDED/ 
DOUBLE-DENSITY 
FLEXIBLE DISK 



ISBX' 1 " 218 

FLEXIBLE DISK 

CONTROLLER 



ISBC-056A 

2S6K RAM MEMORY 

BOARD 




ISBC215 

WINCHESTER DISK 
CONTROLLER 



^VJSBC«680 
CHASSIS 



ISBC® 88/30 

SINGLE BOARD 

COMPUTER 



ISBC 337 

MULTIMODULE™ 

NUMERIC DATA 

PROCESSOR 



x-060 



Figure 2-1. System 86/330A Internal Location Diagram 



Power Supply 

The power supply is mounted to the chassis at the rear panel. It is a switching 
power supply providing power to all elements of the system with sufficient reserve 
(92.5W) remaining for user-installable options. Refer to the SYSTEM 86/330A IN- 
STALLATION AND MAINTENANCE MANUAL for the power supply 
specifications. 



Cardcage and Backplane 

The six-slot cardcage is mounted within the chassis on the extreme left side. The 
power supply routes DC power to all the backplane via connector P3. All boards 
are installed such that the component side faces to the right when viewed from the 
front. In the standard configuration, the boards fit into the slots as follows (where 
slot connector Jl is on the far left side and slot connector J6 is on the far right side, 
when viewed from the front) : 



Backplane Slot 


Board 


Jl 


Processor board 


J2 


Not available 


J3 


Available for expansion 


J4 


Available for expansion 


J5 


256K byte memory board 


J6 


Intelligent disk controller board 
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Hereafter, the descriptions within this manual assume that the system is in the 
standard hardware configuration. 

The front panel is mounted in front of the cardcage and interfaces to the backplane 
via connector P2 on the processor board. This cardcage/backplane supports the 
Intel Multibus System Bus configuration for 8- or 16-bit data transfers and 16-, 
20-, or 24-bit addresses. 

Bus contention between the processor board and the disk controller or other Mul- 
tibus masters is resolved by a parallel resolution circuit within the backplane. The 
disk controller board has the highest priority and the processor board has the 
lowest priority. 



Processor Board 

The processor board consists of an Intel iSBC 86/30 Single Board Computer upon 
which is mounted an iSBC 337 Numeric Data Processor Multimodule board. 

The iSBC 86/30 board is a Multibus master with a 16-bit microprocessor (8086), 
32K bytes of ROM memory, 128K bytes of dual port RAM memory, a Pro- 
grammable Interval Timer (8253) that controls baud rates, a Programmable Inter- 
rupt Controller (8259A), a programmable USART (8251 A) for RS232 serial I/O 
communications, and a Programmable Peripheral Interface (8255 A). 

The iSBC 337 Numeric Data Processor adds extensive high-speed numeric pro- 
cessing capabilities to the iSBC 86/30 board. This Multimodule board includes an 
Intel 8087 numeric processor extension (NPX). The interface between the 8087 
and the 8086 extends the instruction set by adding over 60 additional numeric in- 
structions and six additional data types. 

In addition, you may want to add an iSBX Multimodule board. These boards allow 
you to add features to your basic processor at a low cost. One example is an iSBX 
352 board which allow you to add a serial interface. 

Refer to the iSBC 86/14 AND iSBC 86/30 SINGLE BOARD COMPUTER 
HARDWARE REFERENCE MANUAL for a functional description of the iSBC 
86/30 board. Refer to the iSBC 337 MULTIMODULE NUMERIC DATA PRO- 
CESSOR HARDWARE REFERENCE MANUAL for a functional description of 
the iSBC 337 board. 



Memory Board 

The RAM memory board is an iSBC 056A board providing the system with 256K 
bytes of additional memory. This brings the system total to 384K bytes of memory. 

Refer to the iSBC 016A/032A/064A/028A/056A RAM BOARD HARDWARE 
REFERENCE MANUAL for a functional description of the iSBC 056 A board. 



Disk Controllers 

The disk controllers consist of an iSBC 215 Winchester disk controller to which is 
attached an iSBX 218 Flexible disk controller Multimodule board. 



2-3 



Hardware Overview System 86/330A 

iSBC 21 5 Winchester Disk Controller 

The iSBC 215 Winchester disk controller is an 8089-based I/O processor which 
controls the Winchester drive in the Multibus environment. It provides full sector 
buffering, on-board ECC (error checking and correction), and automatic 
defective-track handling. It also features automatic error recovery and retry, and 
transparent data-error corrections. It can detect errors of up to 32 bits in length 
and can correct errors of up to 1 1 bits in length. 

Refer to the iSBC 215 WINCHESTER DISK CONTROLLER HARDWARE 
REFERENCE MANUAL for a functional description of the iSBC 215 board. 

iSBX 21 8 Flexible Disk Controller 

The iSBX 218 Flexible disk controller is a double-wide Multimodule board which 
is attached to the iSBC 215 board. It controls all command, data, and status be- 
tween the flexible disk drive and the processor board via the iSBC 215 board. 

Refer to the iSBX 218 FLEXIBLE DISK CONTROLLER HARDWARE REFER- 
ENCE MANUAL for a functional description of the iSBX 218 board. 

Winchester Disk Drive 

The Winchester disk drive is a 35M byte, non-removable media, 8-inch disk drive. 
The head/disk assembly is completely enclosed and does not require any sche- 
duled maintenance. The Winchester drive is mounted in the peripheral bay with a 
filler panel mounted in front of the drive (see Figure 2-1) . 

Flexible Disk Drive 

The flexible disk drive is a 1M byte double-sided, double-density drive. It is 
mounted in the right-most peripheral bay such that the door access button is posi- 
tioned to the right of the diskette door as viewed from the front. 
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CHAPTER 3 
SOFTWARE OVERVIEW 



The following software is available with the System 86/330A Microcomputer 
System: 

• A ready-to-run version of the iRMX 86 Operating System (called the precon- 
figured version of the Operating System), which is already configured for use 
in a System 86/330A environment. 

• A configurable version of the iRMX 86 Operating System, which you can 
extend to provide any additional support you need. 

• A monitor and a debugger, which, when used together, provide a powerful 
debugging tool. 

• System diagnostic programs, which check the System 86/330A hardware and 
help you find any possible hardware problems. 

• A powerful, line-oriented text editor, for creating and modifying text files. 

• Language translators and utilities, which allow you to assemble or compile 
your programs, link them together, place them in libraries, and assign abso- 
lute addresses to them. 

This chapter discusses each of the software elements in general and refers you to 
other Intel manuals where you can obtain more information. 



Operating System Software 

The iRMX 86 Operating System is the heart of the System 86/330A software. It is 
a real-time, multiprogramming operating system that manages the resources of 
the System 86/330A Microcomputer System and allows it to respond to its 
environment. The next sections describe some of the features of the iRMX 86 
Operating System. 

Processor Management 

The iRMX 86 Operating System contains the facilities to support the concurrent 
execution of multiple programs (called tasks) . Although tasks can communicate 
with each other by invoking Operating System calls, each task runs independently 
of other tasks in the system. The Operating System resolves contentions between 
tasks by scheduling tasks for execution based on priority and readiness. 

Priority- Based Scheduling 

The Operating System provides a priority-based, event-driven scheduling mecha- 
nism that supports up to 256 different priority levels. The Operating System uses 
task priority to determine which task gains control of the processor; it always gives 
control of the processor to the highest-priority task that is ready to run. That task 
continues to run until a higher-priority interrupt occurs, the task requests 
resources that are not currently available, or the task makes a higher-priority task 
ready. 
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Interrupt- Driven Processing 

The iRMX 86 Operating System is not an active monitor that runs constantly and 
wastes processor time. Instead, it is passive, using no processor resources until an 
interrupt occurs or a task makes a call to the Operating System. The interrupts rep- 
resent requests for service from peripheral devices, such as the Winchester disk or 
the system terminal. Operating System calls represent requests for service from 
tasks. When the Operating System receives an interrupt or a system call, it stops 
the task that is currently running, responds to the request by performing some 
service, and returns control to the interrupted task. 

In an iRMX 86-based application system, interrupt lines have corresponding 
iRMX 86 priorities. When an interrupt occurs, the Operating System immediately 
calls a procedure to handle the interrupt and, if necessary, it schedules a task of 
equal priority to perform further processing. By calling the procedure, which is 
limited in the amount of processing it can do, the Operating System maximizes re- 
sponse time. By scheduling an interrupt task whose priority corresponds to the pri- 
ority of the interrupt, the Operating System allows you to perform extensive pro- 
cessing while at the same time guaranteeing that high-priority interrupts will be 
serviced before low-priority interrupts. 

Object-Oriented Architecture 

The iRMX 86 Operating System provides data structures, called objects, which 
serve as the building blocks of your application system. It also provides a number 
of system calls that operate on these objects and manage the resources of the 
system. The seven object types are: 



Tasks 



Tasks do the work of an iRMX 86 application system. 
Each task in the Operating System has the characteris- 
tics of a unique processor. Each has its own code, 
priority, stack, data area, registers, and status. The 
Operating System schedules tasks to run based on 
their priority. 



Segments 



Segments are blocks of memory that the Operating 
System dynamically allocates to tasks when the tasks 
request memory. Segment size varies according to task 
needs. 



Mailboxes 



Mailboxes provide a mechanism for intertask 
communication. They are structures to which some 
tasks send objects and other tasks wait to receive 
objects. Mailboxes are generally used to pass segments 
from one task to another, but they can be used to trans- 
fer any kind of object. 



Semaphores Semaphores provide a mechanism for task synchroni- 

zation and mutual exclusion. A semaphore is an integ- 
er counter that tasks can increment or decrement. This 
provides a means for one task to signal another that 
processing is complete or that resources are available. 



Regions 



Regions provide mutual exclusion by guarding a 
specific collection of shared data. A region permits 
only one task at a time to access the data guarded by 
the region. 
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Jobs 



Jobs are the environments in which tasks exist. Each 
job contains a group of tasks, the objects used by the 
tasks, an object directory, and an area of memory. Jobs 
provide a multiprogramming environment, with limit- 
ed interaction between tasks in different jobs. 



Composite 
objects 



Composite objects are objects that a user can create to 
provide functions not already available. The Operating 
System treats each new object the same as other 
objects, permitting the user to manipulate and obtain 
information about composite objects. 



Figure 3-1 provides a pictorial description of a single job, showing how the job con- 
tains other iRMX 86 objects as well as a directory and an area of memory. 
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Figure 3-1. An iRMX™ 86 Job 
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The Operating System provides a set of system calls that allow tasks to create 
objects, delete objects, manipulate objects, and request services from the Operat- 
ing System. The iRMX 86 reference manuals describe these system calls in detail. 

Error Processing 

When a task issues an iRMX 86 system call, the results may not always be what 
the task expects. For example, a task might request memory that is not available, 
or it might use an invalid parameter. The Operating System provides a mechanism 
for transferring control, in the event of an error condition, to an error-handling 
routine. The Operating System permits hierarchical error handling and selective 
error processing. Hierarchical error handling means that different levels of errors 
can be handled by different error-handling routines. For example, a system-wide 
error handler can process errors common to a number of tasks. Job-level error 
handlers can process application-specific errors. In addition, an individual task can 
have its own error handler, if necessary. 

Selective error processing means that each task can select the type of errors to be 
processed by the error handlers. Errors are divided into two categories: program- 
ming errors (such as specifying invalid parameters) and environmental conditions 
(such as having insufficient memory to perform an operation) . 

Device-Independent I/O Management 

The iRMX 86 Operating System provides a single set of system calls for managing 
I/O operations. These system calls allow an application program to be device 
independent, since a system call which performs an I/O operation on one device 
also performs the same operation on a different device. The iRMX 86 I/O System 
achieves this device independence by dividing its I/O processing into two parts: 
file drivers and device drivers. 

File drivers are parts of the I/O System that communicate with files. There is a 
separate file driver for each type of file that the I/O System supports. The file types 
include: 

Named files Named files allow applications to refer to files by 

name. Each file name is cataloged in a directory to 
allow the file to be accessed with a minimum of 
overhead. Directories are special named files that store 
directory and access information about other named 
and directory files. 

Physical files Physical files provide a mechanism for applications to 

treat an entire I/O device as a single file. This type of 
file is typically used to communicate with simple 
devices such as printers and terminals. 

Stream files Stream files are mechanisms for communicating be- 

tween tasks. They allow tasks to exchange data as if the 
data were written and then read from a first-in/first-out 
file. 

The file drivers are completely device independent, allowing you to support many 
different kinds of devices without having to modify this part of the Operating 
System. 
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Device drivers are the device-dependent portions of the I/O System. There is a 
separate device driver for each type of I/O device in your system. The iRMX 86 
Operating System supplies device drivers for many standard devices. It also gives 
you the capability to add your own device drivers to the I/O System in order to sup- 
port your own special devices. When your application program wishes to commu- 
nicate with an I/O device, it first must invoke a system call that specifies a file 
driver and a device driver to be used with the device. This establishes the linkage 
between the file driver and the device driver, allowing your application program to 
communicate with a specific device. If, at a later time, you wish to switch to a dif- 
ferent kind of device, you need change only one system call (the call that estab- 
lishes the linkage between file and device driver). The remainder of your applica- 
tion program stays the same. 

Refer to the iRMX 86 BASIC I/O SYSTEM REFERENCE MANUAL, the iRMX 86 
EXTENDED I/O SYSTEM REFERENCE MANUAL, and the GUIDE TO 
WRITING DEVICE DRIVERS FOR THE iRMX 86 AND iRMX 88 I/O SYSTEMS 
for more information about file drivers,- device drivers, and the system calls used 
to communicate with I/O devices. 

Hierarchical Naming of Files 

The iRMX 86 Operating System allows your application system to organize its 
named files into a tree-like structure like the one shown in Figure 3-2. There are 
two kinds of files in a hierarchical structure: data files (represented by triangles in 
the figure) and directory files (represented by rectangles in the figure). This hier- 
archy allows data to be grouped logically and accessed with a minimum of 
overhead. 
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Figure 3-2. Hierarchical File Naming 
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Configurability 

The iRMX 86 Operating System is the foundation on which a great variety of appli- 
cation systems can be built. As such, it is structured in a manner that allows users 
to select the particular features of the Operating System that they want and to dis- 
card any unused portions. This selection process is called configuration. 

To aid in the configuration process, the Operating System is divided into a number 
of major pieces, called layers. When you configure the Operating System, you can 
select the layers you want for your application system and discard the rest. Figure 
3-3 illustrates the layers that form the preconfigured version of the iRMX Hb 
Operating System. Other layers also exist. 




Figure 3-3. iRMX™ 86 Layers 



The layers available with the configurable version of the iRMX 86 Operating 
System include: 

The Nucleus is the core of the iRMX 86 Operating 
System and is required by every application system. It 
provides facilities that perform processor management 
and scheduling, interrupt management, memory 
management, object control, and error management. 



Nucleus 
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Refer to the iRMX 86 NUCLEUS REFERENCE 
MANUAL and the iRMX 86 SYSTEM PROGRAM- 
MER'S REFERENCE MANUAL for detailed infor- 
mation about the Nucleus. 



Terminal 
Handler 



The Terminal Handler provides a real-time interface 
between a terminal and the application system. It is 
useful for users who require the ability to communicate 
with the system but who do not need the full services 
of an I/O System. Refer to the iRMX 86 TERMINAL 
HANDLER REFERENCE MANUAL for more 
information. 



Debugger 



The Debugger provides the facilities for interactively 
debugging tasks. It allows you to debug several tasks 
while the remainder of the system continues to run. 
Refer to the iRMX 86 DEBUGGER REFERENCE 
MANUAL for more information. 



Basic I/O 

System 



The Basic I/O System provides an extensive facility for 
device-independent I/O. It supplies all file drivers and 
a number of device drivers. It implements an asynchro- 
nous interface to I/O operations, allowing tasks expli- 
citly to overlap I/O functions with other operations. 
Refer to the iRMX 86 BASIC I/O SYSTEM REFER- 
ENCE MANUAL and the iRMX 86 SYSTEM PRO- 
GRAMMER'S REFERENCE MANUAL for more 
information. 



Extended I/O The Extended I/O System provides a higher-level 

System interface to files than the Basic I/O System provides. 

The Extended I/O System provides a simple, synchro- 
nous interface to I/O operations, one which automati- 
cally performs read-ahead and write-behind buffering. 
This synchronous interface also allows tasks to use log- 
ical names to refer to files. Refer to the iRMX 86 EX- 
TENDED I/O SYSTEM REFERENCE MANUAL 
and the iRMX 86 SYSTEM PROGRAMMER'S 
REFERENCE MANUAL for more information. 



Application 
Loader 



The Application Loader provides a simple mechanism 
for loading application code and data files from I/O 
devices into system memory. It can load absolute code 
into fixed locations or relocatable code into 
dynamically-allocated memory locations. Moreover, it 
can load files containing overlays. Refer to the iRMX 
86 LOADER REFERENCE MANUAL for more 
information. 
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Bootstrap 
Loader 



The Bootstrap Loader provides a means of loading the 
entire application system into system memory from an 
I/O device. It can be configured to load from a specific 
device or to use the first device that becomes ready 
once the system has been started. It can also be confi- 
gured to load a file specified by the operator at the 
terminal. A version of the Bootstrap Loader resides in 
PROM on the processor board, allowing you to load 
your application system immediately. 



Human 
Interface 



The Human Interface is the outermost layer of the 
iRMX 86 Operating System. It is an interactive inter- 
face between the user and the application system. It 
gives the user the ability to invoke an application pro- 
gram from the terminal by specifying the name of the 
file that contains the program. 



Supplied with the Human Interface are several pro- 
grams called commands. The Human Interface com- 
mands perform many operations, including: 



• Creating, copying, renaming, and deleting files. 

• Loading and starting application programs. 

• Formatting and verifying device volumes. 

• Backing up and restoring files on devices. 

• Reading commands from a file, instead of from the 
terminal. 

• Communicating with the iSBC 957B package to 
debug programs and to copy files to and from an 
Intel development system. 



The Human Interface also provides a number of 
system calls that an application program can invoke to 
access Human Interface services. Refer to the iRMX 
86 HUMAN INTERFACE REFERENCE MANUAL 
for more information. 



In addition to being able to select the layers of the Operating System that you want 
to include in your application system, you can also configure the individual iRMX 
86 layers. You can include or exclude features, include or exclude system calls, 
and specify hardware port addresses so that your customized Operating System can 
run on any iAPX 86- or iAPX 88-based system. Refer to the iRMX 86 CON- 
FIGURATION GUIDE for more information about the configuration process. 
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Because the Operating System is configurable, it also allows you to add support for 
loosely-coupled multiprocessing. The Multibus Message Exchange (iMMX 800) 
software package provides the software needed to allow communications between 
processor boards via the Multibus interface. If you add the iMMX 800 package, 
your iRMX 86 tasks can communicate with tasks running on other processor 
boards. Refer to the iMMX 800 SOFTWARE REFERENCE MANUAL AND 
USER'S GUIDE for more information about iMMX 800 software. 

The System 86/330A Microcomputer System includes both a configurable version 
of the iRMX 86 Operating System and a preconfigured version. With the preconfi- 
gured version, you can start running your System 86/330A Microcomputer 
System immediately upon power up. You can use this "standard" system to tailor 
the configurable version of the Operating System to your needs and generate your 
own customized application system. Then, you can bootstrap load your customized 
system and continue from there. 

Because the iRMX 86 Operating System is configurable, you can also customize 
your system to allow communication between the System 86/330A Microcomput- 
er System and devices on an Ethernet network. 

Preconfigured Operating System 

One of the diskettes supplied with the System 86/330A Microcomputer System, 
the System 86/330A Installation Diskette, contains as one of its files a version of 
the iRMX 86 Operating System that you can run immediately. This version, called 
the preconfigured version of the Operating System, is configured to run on the 
standard System 86/330A hardware. As illustrated in Figure 3-3, it contains the 
following fully-configured layers: 

• Nucleus 

• Basic I/O System, complete with device drivers for the following devices: 

Terminal 

Flexible and Winchester disk drives (iSBC 215/218 controllers) 

Line printer with parallel interface 

• Extended I/O System 

• Application Loader 

• Human Interface 

In addition to these layers, the preconfigured version also contains a job which ini- 
tializes the iRMX 86 System Debug Monitor and then deletes itself. The System 
Debug Monitor is an extension of the iSBC 957B monitor which allows you to 
debug your application system by examining iRMX 86 data structures. These 
mQnitors are discussed later in this chapter. 

The iRMX 86 Bootstrap Loader, which resides in PROM on the System 86/330A 
Microcomputer System, is used to load the Operating System from diskette and to 
begin system operation. 

Chapter 6 contains further, detailed information about the preconfigured version 
of the Operating System. 
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Monitor 

In addition to the iRMX 86 Operating System, the System 86/330A Microcomput- 
er System contains the iSBC 957B monitor, which resides in PROM on the proces- 
sor board. This monitor allows you to perform basic debugging and memory exam- 
ination functions without the presence of the Operating System. With the 
monitor, you can perform the following operations: 



• Set breakpoints in programs or single-step through code. 

• Examine and modify registers and memory. 

• Perform I/O via 8086 input and output ports. 

• Move and compare blocks of memory. 



Also, if you change the jumpers on the iSBC 86/30 board and use a parallel-load 
cable to connect the parallel port of the iSBC 86/30 board to an Intel Microcomput- 
er Development System, you can use the load features of the iSBC 957B package 
to transfer files between the development system and your System 86/330A Mi- 
crocomputer System. See the SYSTEM 86/330A INSTALLATION AND MAIN- 
TANENCE MANUAL for more information on how to change the jumpers on 
the iSBC 86/30 board. Refer to the USER'S GUIDE FOR THE iSBC 957B iAPX 
86, 88 INTERFACE AND EXECUTION PACKAGE for information about moni- 
tor commands and for information on how to set up your hardware to support the 
load features. 

You can access the monitor in one of two ways: 



• By pressing the INTRPT button on the front panel. This method works if you 
include the System Debug Monitor (discussed in the next section) in your 
application system or if you connect the INTRPT button to the nonmaskable 
interrupt of iSBC 86/30 board. In both cases, pressing the INTRPT button in- 
terrupts the application system and gives control to the monitor, which waits 
for your entry. 

• By entering the Human Interface DEBUG command. This loads a program 
into memory and gives control to the monitor, permitting you to examine 
the program in detail. The iRMX 86 HUMAN INTERFACE REFERENCE 
MANUAL describes the DEBUG command in more detail. 



iRMX 86 System Debug Monitor 

The iRMX 86 System Debug Monitor (SDB) is an extension of the iSBC 957B 
monitor. It adds additional commands to the monitor to allow you to examine 
iRMX 86 objects directly. If you include the SDB in your application system, you 
can use the SDB commands whenever you access the iSBC 957B monitor, after 
bootstrap loading the Operating System. Refer to the iRMX 86 SYSTEM DEBUG 
MONITOR REFERENCE MANUAL for more information. 

The preconfigured version of the Operating System includes the SDB. The confi- 
gurable version of the Operating System contains libraries for the SDB so that you 
can include the SDB in your customized Operating System. 
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System Diagnostic Programs 

Three diagnostic packages accompany the System 86/330A Microcomputer 
System. These packages include: 

• System Confidence Test (SCT) 

• System Diagnostic Test (SDT) 

• System Analysis Test (SAT) 

These diagnostic packages exercise all the System 86/330A hardware and check 
for errors. The following sections discuss the individual diagnostic packages. 

System Confidence Test (SCT) 

The SCT provides a basic check of each hardware element of the System 86/330A 
Microcomputer System. It resides in PROM on the processor board of the system 
(along with the monitor and the Bootstrap Loader) and runs when you apply 
power to the system or press the RESET button. 

When the SCT starts running, it first performs a memory test and checks to see if 
it can communicate with the terminal. If your terminal's baud rate is 9600, after 
approximately five seconds, it displays a series of asterisks at the terminal. 



NOTE 



If your terminal's baud rate is not 9600, characters other than 
asterisks may be displayed. It is possible that the characters may 
not be displayed. 



Enter an upper-case "U" at the terminal to generate a display that shows the prog- 
ress of the remainder of the SCT. It updates this display as it completes each rou- 
tine in the test. A period (.) indicates the successful completion of a portion of the 
test; a question mark (?) indicates an error condition. Figure 3-4 shows the display 
of a successfully-completed SCT. If you have added extension modules to your 
system, this display may contain other entries. For more detailed information 
about the SCT, refer to the SYSTEM 86/300 SERIES DIAGNOSTIC MAINTE- 
NANCE MANUAL. 

Upon successful completion, the SCT passes control to the iRMX 86 Bootstrap 
Loader which loads the Operating System from disk and starts it running. 
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Figure 3-4. Successfully-Completed SCT Display 



System Diagnostic Test (SDT) 

The System Diagnostic Test (SDT) provides a means of isolating a hardware prob- 
lem to a specific sub-assembly. It contains a number of subtests that you can speci- 
fy to isolate problems to a particular board in the system. 

To invoke the SDT, you must interrupt into the monitor and call the Bootstrap 
Loader. Refer to the SYSTEM 86/300 SERIES DIAGNOSTIC MAINTENANCE 
MANUAL for detailed information about the SDT. 



System Analysis Test (SAT) 

The System Analysis Test (SAT) provides a means to exercise the system hard- 
ware by running the system software for extended periods of time. This permits 
isolation of subtle problems to a sub-assembly if elusive intermittently-reported 
errors occur. 

You invoke the SAT by entering a command at the terminal. The SAT then 
compiles a test program, links the program with necessary libraries and starts the 
program running as an iRMX 86 task. The test program checks out the various 
parts of the system and returns messages to the system console to indicate errors. 
Refer to the SYSTEM 86/300 SERIES DIAGNOSTIC MAINTENANCE 
MANUAL for detailed information about the SAT. 
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Text Editor 

The System 86/330A Microcomputer System contains a sophisticated, line- 
oriented editing facility called EDIT. You invoke EDIT by entering a command at 
the terminal. You can then use EDIT commands to create and modify files of text. 
EDIT provides a number of simple, one-character commands to: 

• Add text (A) 

• Insert text (I) 

• Move text (M) 

• Substitute text (S) 

» Print text at the terminal (P) 

• Read text from a file (R) 

• Write text to a file (W) 

These easy-to-use commands allow you, if you are unfamiliar with EDIT, to begin 
creating and modifying files of text immediately, without having to spend consid- 
erable time learning how to use the editor. 

Later, when you become familiar with the basic editing facilities, you can take ad- 
vantage of EDIT's more powerful features to perform extensive global editing 
functions with compact, one-line commands. You can also use the EDIT macro 
processor, which allows you to process a complex string of commands by entering 
a single command and which allows you to define blocks of text which can be 
included anywhere in the text file. 

For more information about EDIT, refer to the EDIT REFERENCE MANUAL, 
which contains a tutorial to lead you step-by-step through the basic EDIT 
commands. It also contains a comprehensive description of each EDIT command. 
The next chapter of this manual contains an example which shows you how to use 
EDIT when writing a program. 



Language Translators and Utilities 

The System 86/330A Microcomputer System contains, as standard products, a 
number of language translators and utilities. Other optional language products are 
also available. The following sections describe these products. 

Standard Language Products 

The System 86/330A Microcomputer System contains several language translators 
and utilities which you can invoke by entering commands at the terminal. These 
translators and utilities allow you to compile or assemble programs, link programs 
together, assign absolute addresses to programs, create libraries of programs, and 
convert absolute object modules to hexadecimal format. The translators and utili- 
ties supplied with the System 86/330A Microcomputer System consist of: 

ASM86 The 8086/8087/8088 macro assembler. 

PLM86 The PL/M-86 compiler. 

LINK86 The 8086 Linker, which combines individually- 

compiled object modules into a single, relocatable 
object module. 
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CREF86 A program that scans 8086 object modules to provide a 

cross-reference of external and public symbols in 
multiple modules. 

LOC86 The 8086 Locater, which assigns absolute addresses to 

relocatable object modules. 

LIB86 The 8086 Librarian, which creates and maintains 

object module libraries. 

OH86 A program which converts absolute object modules to 

hexadecimal format. 



With these products you can create executable programs which you can invoke 
from the terminal. You can also create application tasks and configure the iRMX 
86 Operating System to include these tasks. Finally, if you are an OEM (original 
equipment manufacturer) you can include these languages with your end product 
to give your customers the ability to program the System 86/330A Microcomputer 
System. See the Intel Master Software License Agreement for your rights concern- 
ing passing software to your customers. 

All the System 86/330A language products are compatible with those available on 
Intel Microcomputer Development Systems. Thus you can develop part of your 
application on a development system such as a Series III and part of it on the 
System 86/330A Microcomputer System. 

For more information about the language translators and utilities, you should 
refer to the individual manuals for the specific products. These manuals include: 



ASM86 MACRO ASSEMBLY LANGUAGE REFERENCE MANUAL 

ASM86 MACRO ASSEMBLER OPERATING INSTRUCTIONS FOR 
8086-BASED DEVELOPMENT SYSTEMS 

PL/M-86 USER'S GUIDE 

iAPX 86, 88 FAMILY UTILITIES USER'S GUIDE 



The next chapter also contains some examples of using the language translators 
and utilities. 



Optional Language Products 

In addition to the standard language products, you can also obtain the following 
Intel language products for use on the System 86/330A Microcomputer System: 

Pascal-86 A Pascal compiler that provides a strict implementa- 

tion of the proposed ISO standard. It also provides ex- 
tensions of the language to allow you to write programs 
specifically for microcomputers. 



3-14 



System 86/330A 



Software Overview 



FORTRAN-86 A FORTRAN compiler that provides total compatibili- 

ty with existing FORTRAN-86 code, plus many new 
language features listed in the FORTRAN-77 language 
standard. 

Contact your local Intel sales representative or distributer for more information 
about optional Intel language products. 

Also, the iRMX 86 Operating System supports UDI (Universal Development 
Interface), a standard method for application programs to request operating 
system services. Because of this interface, a wide variety of optional language 
products, both compilers and interpreters, are available from independent software 
vendors for use on the iRMX 86 Operating System. Contact your local Intel sales 
representative or distributer for more information about the optional language pro- 
ducts that are available through independent software vendors. 
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CHAPTER 4 
USING THE SYSTEM 



This chapter takes you step-by-step through a sample program development ses- 
sion on the System 86/330A Microcomputer System. If you are unfamiliar with 
the Human Interface commands or with the iRMX 86 language products, this 
chapter can help you get started using the system. It covers each step in the devel- 
opment process of a program, from starting up the system to running a program. If 
you wish, you can follow along on your own system, performing the same opera- 
tions that this chapter lists. The operations include: 



• Starting the system and bootstrap loading the Operating System. 

• Entering a PL/M-86 source program into a file by using the editor. 

• Compiling the program with the PL/M-86 compiler. 

• Using LINK86 to link the program with iRMX 86 interface libraries. 

• Running the program. 



The next section lists assumptions on which this chapter is based. These assump- 
tions concern your System 86/330A hardware and software. The remaining sec- 
tions of this chapter discuss the development operations. 



Assumptions 

This chapter makes the following assumptions about your System 86/330A hard- 
ware and software: 



A terminal configured for 9600 baud is connected to the Jl connector on the 
back of the System 86/330 A Microcomputer System. This allows you to com- 
municate with the system. 

The System 86/330A software is already installed on the Winchester disk. If 
you have not followed the installation procedures to transfer the software 
from the installation diskette to the Winchester disk, you should do so 
before reading further in this manual. The SYSTEM 86/330A INSTALLA- 
TION AND MAINTENANCE MANUAL describes this installation 
procedure. 

You are running the preconfigured version of the Operating System. If you 
have configured your own version of the Operating System, the system may 
respond differently than this chapter indicates. 
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Starting the System 

To start the system and bootstrap load the Operating System, perform the follow- 
ing steps (see "Assumptions" section before beginning): 

1. Turn on the power to both the System 86/330A Microcomputer System and 
the terminal to which it is connected. The System 86/330A power switch is 
located on the lower right portion of the front panel. The System Confidence 
Test (SCT) starts running; in approximately five seconds it should begin dis- 
playing a series of asterisks (*) at the terminal. 

2. Type an upper-case "U" at the terminal. This causes the SCT to continue. 

3. The remainder of the SCT runs, displaying the information shown in Figure 
3-4. The status column on the right of the display shows the status of the 
confidence tests. A "GO" indicates that the test passed; a "NO-GO" indi- 
cates that the test failed. The second test in the SCT, the PIC test, waits ap- 
proximately five seconds for you to enter a character at the terminal. Enter 
an "I" character in response to the period (.) prompt. If you fail to enter a 
character when the SCT displays this prompt, a status of "NO-GO" appears 
for this test. 

When the SCT completes all tests successfully, it displays the following 
information: 



SCT SUCCESSFUL ... NOW BOOTING SYSTEM 



The Bootstrap Loader next loads the iRMX 86 Operating System into 
memory, a process that takes approximately one minute. 

4. When the bootstrap load process completes, the Operating System displays 
the following information: 



SYSTEM 86/330 VI. 1 : user = WORLD 

-DATE 

DATE: 01 JAN 78 

-TIME 

TIME: 00:00:00 

END SUBMIT LOGIN 



The date and time messages inform you of the date and time that the system 
assumes. This is a reminder for you to set the correct date and time in the 
system. Do this by entering the DATE and TIME Human Interface 
commands, as follows (user input is underscored): 



— DATE dd mmm yy 
DATE: dd mmm yy 
— TIME hh:mm:ss 
TIME: hh:mm:ss 



where dd mmm yy indicates the current date (such as 01 MAR 82 or 23 APR 
83) and hh:mm:ss indicates the current time (such as 11:45:00 or 14:30:45). 
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Refer to the iRMX 86 HUMAN INTERFACE REFERENCE MANUAL for 
specific information on these commands. You should always set the data and 
time when you restart the system. 

You can now proceed with your program development or enter any Human 
Interface commands you wish. 



Creating the Source Code of a Program 

Now that you have bootstrap loaded the Operating System, you can use EDIT, the 
text editor, to enter the source code of a program into a file. To start this process, 
enter the following command: 

-ED 



EDIT responds by displaying a sign-on message and a prompt (the asterisk 
character) , as follows: 



iRMX 86 LINE EDITOR, Vx.x 

* 



The asterisk indicates that you are communicating with EDIT. You can now enter 
any of the commands described in the EDIT REFERENCE MANUAL. 

To begin entering the program, use the add (A) command. Enter the following: 



You can now enter the text of a program. Figure 4-1 contains a sample PL/M-86 
program that you can enter. This program displays the letters of the alphabet and 
asks you for permission to continue. It is a simple program that uses Human Inter- 
face and Extended I/O System calls to communicate with the terminal. You can 
examine the listing in Figure 4-1 to determine how the program works, or you can 
simply enter the program as it is listed. 

In order for the sample program to execute correctly, you must include two files 
that consist of external declarations for the iRMX 86 system calls. These files 
(EIOS.EXT and HI.EXT) are two of the interface libraries that reside on the con- 
figuration diskette. Before you can compile the program you must copy these li- 
braries from the configuration diskette to the Winchester disk. See Chapter 6 in 
this manual for more information on installing the INCLUDE files in the appropri- 
ate directories. 



EIOS.EXT (externals necessary to use the Extended I/O System) and HI.EXT 
(externals necessary to use the Human Interface) contain all the external 
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declarations that this program requires. As Figure 4-1 shows, to include these 
files, enter the following lines in the program: 

$INCLUDE(EIOS.EXT) 
$INCLUDE(HI.EXT) 

These INCLUDE statements include the files in the compilation of the program. 



alph: DO; 

DECLARE TOKEN LITERALLY 'WORD'; 

/* 

* External declarations for iRMX 6b system calls are in the 

* include fi les 

*/ 

$INCLUDE(/RMXINC/EIOS.EXT) 
$INCLUDE(/RHXINC/HI.EXT) 

/* 

* End of external declarations 
*/ 

/* 

* Declare local variables 
*/ 

DECLARE 

CR LITERALLY 'DDh' ■> 
LF LITERALLY 'DAh' -. 

alphabet(Sb) BYTE DAT A ( ' ABCDEFGHI JKLMNOPURSTUVUXYZ ' ) -i 

& 

^ excep UORDn 

nSletter U0RD-, ?fv£. t€> Au?A^*f" 

msg STRUCTURE! _ e _. ^ 

length BYTE, x^*~«- *> ' 

h char BYTE, 3i ^<^ ^ v>4^ ^ ^ s H „ 

'^CRSchar BYTE, w ^A^i^i- "'A ^ ' n '_ ^ c ^^" 

©LFSchar BYTE), 

read$buffer STRUCTURE! 
length BYTE-, 

char(flQ) BYTE), 



Figure 4-1. Sample Program 
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J? cf 



initial$msg(*) BYTE DATA (2ti 'Letters of the alphabet :• -.. 

(3CR-, LF)-g) 
continue <?msg ( *) BYTE DATA(Sl-i'EnterYtocontinue:')i 

/* / 

* Set up structures and write initial message 
*/ 



^ \^ ) n$letter = Oi foiw^C-tt^-* A<-C>bA&sr- ^riAirr- /Vr ^ 

»^ >^ I ., msg - length = 3i , ,, 

V ^ tf msg-CRtchar = CR; *« o^.u^ -r ^ 

Li^msg-LFSchar =LFi __.„---" (g) 

call rq^CSsendSCOSresponse ( On Di ©Initial $msg n @excep)n 
readSbuf f er -char CO) = ' Y' i ^1 J 'iYi 4-vi?£, vcpp VYhl{fYC/{-£. 

/* 

* Display letters whi le response is Y 
*/ 

DO WHILE ( (read$buffer.char(0) = ' Y' ) OR ? Aiu>fl"& Pe> jtr; w>v;t • <i vO«. 

(readSbuf fer-char(D) = 'y ' ) ) i i ° p f ?- '*- CK 7 - ur^ZiZ- cA<=c 

msg- char = alphabet (nSletter) i 6C,:V ^ 

call rq$C$send$CO$response ( Dn On insgi @excep)i 

call rq$C$send$CO$response ( @read$buffern 

SIZE(read$buffer) -■ 
@continue$nsgi 

n$letter = Cn$letter + l)l10D3H @excep) i 

ENDi 

/* 

* Exit 
*/ 

callrqSexitSioSjobCexcepn Di @excep ) ; 

END alphi 



Figure 4-1. Sample Program (continued) 



When you have finished entering the program (or if you wish to stop the process 
for some reason), enter a period (.) as the only character On a line. This informs 
EDIT that you are through entering text. This entry and response appear as: 
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Now you should check the program to ensure that you have entered it correctly. 
First, use the number (N) command to cause EDIT to display line numbers when- 
ever it displays the text of the program. Enter the following: 

*N 



Next, use the print (P) command to display the first few lines of the program. 
Enter the following: 

* 1,10P 

If you have entered the program exactly as shown in Figure 4-1, EDIT displays the 
first ten lines of the program, as follows: 



alph: DO; 

DECLARE TOKEN LITERALLY 'WORD'; 

/* 

* External declarations for iRMX 86 system calls are in the 

* include files 
*/ 



10: $INCLUDE(/RMXINC/EIOS.EXT) 

You should check these lines against Figure 4-1 to ensure that you have made no 
errors. If you have made errors, you can use EDIT commands to correct the text. 
For example, if you made a typing error in line 3, causing it to appear as: 



3: DECLARE TOKEN LITRALLY 'WORD'; 

you can use the substitute (S) command to correct the error. This command and 
response would appear as: 



* 3s/LITRALLY/LITERALLY/p 

3: DECLARE TOKEN LITERALLY 'WORD'; 

The "3" specifies the line number, the "s" indicates the substitute command, the 
values between the slashes indicate the old value and the new value, and the "p" 
causes EDIT to print the line after it makes the change. You can also use other 
commands to change the text; refer to the EDIT REFERENCE MANUAL for 
more information. 

After you have examined the first ten lines, check the rest of the program for 
errors. You can enter a command such as: 



* ll,30p 
to print out the next 20 lines, or you can use an over (0) command, such as: 

* llo 
to display the next "screen" of information (22 lines). 
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After verifying that you have entered the program correctly, use the write (W) 
command to write the program to a file. The following command writes the pro- 
gram to a file called ALPHA.P86 in the :PROG: directory: 

* w:PROG:ALPHA.P86 
:PROG:ALPHA.P86: 90 lines, 1850 bytes. 



The response from EDIT that indicates the number of lines and bytes in the file 
may differ depending on how you enter the program. 

EDIT does not save the program in a disk file unless you use the write command. 

Finally, use the quit (Q) command to exit EDIT, as follows: 

*q 



The dash (— ) prompt indicates that you have exited the editor and are again com- 
municating with the Human Interface. 



Compiling The Program 

The next step in the program development process is compiling the program. To 
do that, enter the following command: 



-PLM86 :PROG:ALPHA.P86 COMPACT 



This command invokes the PL/M-86 compiler, which compiles the program. The 
compiler automatically places the object code in the file :PROG:ALPHA.OBJ and 
the listing lines in the file :PROG:ALPHA.LST. 

In response to the command, the compiler should display the following 
information: 



iRMX 86 PL/M-86 COMPILER Vx.x 

PL/M-86 COMPILATION COMPLETE. WARNINGS, ERRORS 



However, if there is an error in the compilation, you should examine the listing 
file to determine the cause of the error and refer to the PL/M-86 USER'S GUIDE 
for more information. To display the listing file, enter the following command: 



-COPY :PROG:ALPHA.LST 



This command displays the entire listing file at the terminal. If the listing file is 
long and starts scrolling off the terminal screen, you can enter CTRL/s (press the 
CTRL key, and while holding it down, press the s key) to stop the listing. CTRL/q 
resumes the listing. 
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Linking The Program 

Since the program invokes iRMX 86 system calls, you must link the program's 
object code with iRMX 86 interface libraries. These interface libraries satisfy exter- 
nal references generated by the calls in your program. You must link the program 
to the following interface libraries: 

HPIFC.LIB (Human Interface) 

EPIFC.LIB (Extended I/O System) 

RPIFC.LIB (Nucleus) 

These interface libraries reside on the configuration diskette. Before you can link 
the program, you must copy these libraries from the configuration diskette to the 
Winchester disk. See Chapter 6 in this manual for more information on installing 
the libraries in the appropriate directories. 

To link the program correctly, enter the following command: 

- LINK86:PROG:ALPHA.OBJ, & 

** /RMXLIB/HPIFC.LIB, & 

** /RMXLIB/EPIFC.LIB, & 

** /RMXLIB/RPIFC.LIB & 

** TO :PROG:ALPHA BIND SEGSIZE (STACK (800)) 

This command invokes LINK86, which links the program's object code with the 
three interface libraries and places the output module in a file called ALPHA 
under directory :PROG:. LINK86 automatically places the link map in the file 
:PROG:ALPHA.MPl. The BIND parameter is necessary for generating an output 
module which the Human Interface can load into any available dynamic memory. 
The SEGSIZE parameter is necessary for allocating a stack that is large enough to 
accommodate the iRMX 86 system calls. 

In response to the command, LINK86 should display the following information: 
iRMX 86 8086 LINKER Vx.x 



If there is an error in the link process, LINK86 generates additional messages. In 
such a case, examine the link map (:PROG:ALPHA.MPl) for more specific 
information. Also refer to the iAPX 86, 88 FAMILY UTILITIES USER'S GUIDE 
for more information about LINK86. 



Running The Program 

After linking the program, you can run it by specifying the name of the file that 
contains the linked object code. In this case, the name of the file is 
:PROG: ALPHA. However, the directory :PROG: is special in that it is one of the 
directories that the Human Interface automatically searches whenever you enter a 
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command and do not specify a directory name. (Refer to Chapter 6 for information 
about other such directories.) Therefore, to invoke the program, enter the follow- 
ing command: 

- ALPHA 

The program responds by displaying: 

Letters of the alphabet: 

A 

Enter Y to continue: 

If you enter a "Y", the program displays the next character; if you enter any other 
character, the program terminates. 
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CHAPTERS 
DOCUMENTATION 



This chapter lists and briefly describes all of the documentation available with the 
System 86/330A Microcomputer System. This documentation includes system 
manuals, software manuals for all software elements of the system (iRMX 86 
Operating System, language translators and utilities, diagnostics, monitor, and 
debug monitor), and hardware manuals for the chassis and for all boards. Addi- 
tional copies of these manuals can be purchased from: 



Literature Department 
Intel Corporation 
3065 Bowers Avenue 
Santa Clara, C A 95051 



System 86/330A Manuals 

The following manuals deal specifically with the System 86/330A Microcomputer 
System. 



• SYSTEM 86/330A OVERVIEW MANUAL (Order Number: 144680) 

This is the manual you are reading. It is designed to introduce you to the 
System 86/330A Microcomputer System, give you an overview of the hard- 
ware and software elements of the system, and describe each of the Intel 
manuals available with the system. In addition, it describes some things you 
should know about the preconfigured version of the iRMX 86 Operating 
System. 



• SYSTEM 86/330A INSTALLATION AND MAINTENANCE MANUAL 
(Order Number: 144777) 

This manual describes how to take the System 86/330A Microcomputer 
System as it is shipped from the factory, unpack it, set up the hardware, and 
install the operating system and the preconfigured software. It also contains 
procedures to allow you to access and service the individual hardware 
elements. 



SYSTEM 86/300 SERIES DIAGNOSTIC MAINTENANCE MANUAL 
(Order Number: 144813) 

This manual describes the diagnostic programs available with the System 
86/330A Microcomputer System. It discusses how to invoke the diagnostics 
and how to interpret the error messages that can result from running the 
diagnostics. 
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iRMX 86 Manuals 

The following manuals document the iRMX 86 Operating System. 



INTRODUCTION TO THE iRMX 86 OPERATING SYSTEM (Order 
Number: 9803124) 

This manual is designed to introduce engineers and managers to the iRMX 
86 Operating System. It describes how the iRMX 86 Operating System can 
help you develop your application system in less time and at less expense. 



• iRMX 86 NUCLEUS REFERENCE MANUAL (Order Number: 9803122) 

This manual documents the Nucleus, the central portion of the iRMX 86 
Operating System required by all application systems. It provides overview 
information, discusses the functions of the Nucleus in detail, and contains 
detailed descriptions of the system calls available to application 
programmers. 



• 



• 



iRMX 86 TERMINAL HANDLER REFERENCE MANUAL (Order 
Number: 143324) 

This manual documents the Terminal Handler, a layer of the iRMX 86 
Operating System that supports the use of a terminal as an I/O device for an 
application system. It describes the effects of entering certain special key- 
board characters as well as how to use the Terminal Handler for supplying in- 
formation to a task or receiving task output at a terminal. The preconfigured 
version of the iRMX 86 Operating System does not include the Terminal 
Handler. However, the special characters described in the manual are the 
same as those available with the System 86/330A Microcomputer System. 



iRMX 86 DEBUGGER REFERENCE MANUAL (Order Number: 143323) 

This manual documents the Debugger, a layer of the iRMX 86 Operating 
System that allows you to interactively examine your application system in 
order to find and correct errors. It contains introductory and overview mate- 
rial as well as detailed descriptions of all Debugger commands. The preconfi- 
gured version of the iRMX 86 Operating System does not include this 
Debugger. However, this manual is useful if you configure the Debugger 
into your application system. 



iRMX 86 BASIC I/O SYSTEM REFERENCE MANUAL (Order Number 
9803123) 

This manual describes the Basic I/O System, a layer of the iRMX 86 Operat- 
ing System that provides flexible I/O features that are useful in a broad range 
of applications. It contains some introductory and overview material as well 
as detailed descriptions of the system calls available to application 
programmers. 
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• 



iRMX 86 EXTENDED I/O SYSTEM REFERENCE MANUAL (Order 
Number: 143308) 

This manual describes the Extended I/O System, a layer of the iRMX 86 
Operating System that provides easy-to-use, more-automatic I/O features. It 
contains some introductory and overview material as well as detailed descrip- 
tions of the system calls available to application programmers. 



iRMX 86 LOADER REFERENCE MANUAL (Order Number: 143318) 

This manual describes the two loaders available with the iRMX 86 Operating 
System: the Bootstrap Loader and the Application Loader. It contains some 
introductory and overview material as well as detailed descriptions of the 
system calls available with the Application Loader. 



• iRMX 86 HUMAN INTERFACE REFERENCE MANUAL (Order 
Number: 9803202) 

This manual documents the Human Interface, a layer of the iRMX 86 
Operating System that provides an interactive interface between the user and 
the application system. It provides introductory and overview information, 
describes the commands available with the Human Interface, discusses the 
process of creating your own Human Interface commands, and contains 
detailed descriptions of the system calls available to the application 
programmer. 



• 



• 



iRMX 86 DISK VERIFICATION UTILITY REFERENCE MANUAL 
(Order Number: 144133) 

This manual documents the Disk Verification Utility, a software tool that 
runs as a Human Interface command, verifying and modifying iRMX 86 
named and physical volumes. The manual describes how to invoke the 
utility, provides a detailed description of all utility commands, and discusses 
the format of iRMX 86 named volumes. You should read this manual if you 
suspect that one of your volumes is damaged or contains inconsistent 
information. 

iRMX 86 SYSTEM PROGRAMMER'S REFERENCE MANUAL (Order 
Number: 142721) 

This manual documents the more advanced features of the iRMX 86 Operat- 
ing System, those normally reserved for system programmers. It includes dis- 
cussions on using regions, extending the operating system by including new 
types, attaching I/O devices, and creating user objects. It also contains 
detailed descriptions of the system calls reserved for system programmers. 



iRMX 86 PROGRAMMING TECHNIQUES MANUAL (Order Number 

142982) 

This manual provides a number of programming techniques that can reduce 
the amount of time you spend designing and implementing your iRMX 
86-based application system. It includes discussions on PL/M-86 size 
controls, interface procedures, INCLUDE files, timer routines, assembly 
language programming, job communication, configuration, deadlock, termi- 
nal I/O, and stack sizes. 
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GUIDE TO WRITING DEVICE DRIVERS FOR THE iRMX 86 AND 
iRMX 88 I/O SYSTEMS (Order Number: 142926) 

This manual provides instructions that allow you to write your own iRMX 86 
device drivers. You will need to read this manual if you want to communicate 
with devices for which the iRMX 86 Operating System does not already 
supply device drivers. 



• iRMX 86 CONFIGURATION GUIDE (Order Number: 9803 1 26) 

This manual provides the information that allows you to select the iRMX 86 
layers that are appropriate for your application system, tailor them to meet 
your individual needs, and combine them with your own application software 
to form a functional application system. You do not need to read this manual 
if you plan to use only the preconfigured version of the Operating System. 



• iRMX 86 INSTALLATION GUIDE (Order Number: 9803 1 25)^ 

This manual provides information that allows you to set up your target 
system and install the iRMX 86 Operating System on that hardware. It also 
provides information about the iRMX 86 Patching Utility. If you plan to use 
the System 86/330A Microcomputer System as your target system, the por- 
tion of the manual that discusses the Patching Utility is the only portion that 
is relevant. However, if you plan to transfer your software to a board- or 
component-based hardware system, you may find the remainder of this 
manual useful. 



Language Translators and Utilities Manuals 

The following manuals document the language products that accompany the 
System 86/330A Microcomputer System. 



• EDIT REFERENCE MANUAL (Order Number: 143587) 

This manual documents EDIT, an iRMX 86-based text editor which ac- 
companies the System 86/330A Microcomputer System. It contains intro- 
ductory and tutorial material as well as detailed descriptions of all EDIT 
commands. 



ASM86 MACRO ASSEMBLY LANGUAGE REFERENCE MANUAL 
(Order Number: 121627) 

This manual documents the 8086/8087/8088 assembly language, ASM86. It 
describes the assembly language instructions as well as the data types, 
registers, codemacros, and the macro processing language. 



• ASM86 MACRO ASSEMBLER OPERATING INSTRUCTIONS FOR 
8086-BASED DEVELOPMENT SYSTEMS (Order Number: 121628) 

This manual describes how to invoke the assembler. It provides complete de- 
scriptions of all the assembler controls. It also describes how to link assembly 
language programs with PL/M-86 programs. 
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PL/M-86 USER'S GUIDE (Order Number: 121636) 

This manual describes the PL/M-86 language and the use of the PL/M-86 
compiler. It provides complete descriptions of all PL/M-86 language 
statements, discusses compiler invocation, and documents each of the 
compiler controls. 



iAPX 86,88 FAMILY UTILITIES USER'S GUIDE (Order Number: 
121616) 

This manual contains detailed descriptions of the iAPX 86, 88 program de- 
velopment utilities available with the System 86/330A Microcomputer 
System. It describes LINK86, LOC86, LIB86, and OH86. 



RUN-TIME SUPPORT MANUAL FOR iAPX 86, 88 APPLICATIONS 
(Order Number: 121776) 

This manual describes the run-time aids that Intel offers for the iAPX 86, 88 
family of processors. It discusses the run-time support available for iRMX 86 
applications and for applications based on other operating systems. It also 
provides detailed information about logical record systems and the Universal 
Development Interface (UDI). 



• 8087 SUPPORT LIBRARY REFERENCE MANUAL (Order Number: 
121725) 

This manual describes the package of software tools that enables the 8087 or 
the full 8087 emulator to provide a range of floating-point capabilities to 
ASM-86 and PL/M-86 programmers. 



Monitor and Debug Monitor Manuals 

The following manuals document the monitor and debug monitor that accompany 
the System 86/330A Microcomputer System. 



USER'S GUIDE FOR THE iSBC 957B iAPX 86, 88 INTERFACE AND EX- 
ECUTION PACKAGE (Order Number: 143979) 

This manual provides general information, interfacing instructions, and pro- 
gramming information for the iSBC 957B loader and monitor. It provides 
detailed descriptions of the loader and monitor commands. It also contains 
configuration information, which may be of little importance to you since the 
monitor is already configured and available in PROM on your System 
86/330A Microcomputer System. 



iRMX 86 SYSTEM DEBUG MONITOR REFERENCE MANUAL (Order 
Number: 143908) 

This manual documents the extension of the iSBC 957B monitor that allows 
you to examine iRMX 86 objects. This manual contains introductory and 
overview material as well as detailed descriptions of all debug monitor 
commands. It also describes configuration, installation, and invocation. 
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Hardware Manuals 

The following manuals document the individual hardware elements of the System 
86/330A Microcomputer System. 

• iSBC 016A/032A/064A/028A/056A RAM BOARD HARDWARE REFER- 
ENCE MANUAL (Order Number: 143572) 

This manual provides information concerning the specifications, jumper 
configurations, programming considerations, and principles of operation of 
the iSBC 056A RAM memory board. 

• iSBC 215 WINCHESTER DISK CONTROLLER HARDWARE REFER- 
ENCE MANUAL (Order Number: 121593) 

This manual provides information concerning the specifications, interfacing 
considerations, programming considerations, and principles of operation of 
the iSBC 215 Winchester Disk Controller board. 

• iSBX 218 FLEXIBLE DISK CONTROLLER HARDWARE REFERENCE 

MANUAL (Order Number: 121583) 

This manual provides information concerning the specifications, jumper 
configurations, programming considerations, and principles of operation of 
the iSBX 218 Flexible Disk Controller board. 

• iSBC 86/14 AND iSBC 86/30 SINGLE BOARD COMPUTER HARD- 
WARE REFERENCE MANUAL (Order Number: 144044) 

This manual provides information concerning the specifications, jumper 
configurations, interfacing considerations, programming considerations, and 
principles of operation of the iSBC 86/30 Single Board Computer. 

• iSBC 337 NUMERIC DATA PROCESSOR MULTIMODULE HARD- 
WARE REFERENCE MANUAL (Order Number: 142887) 

This manual provides information concerning the specifications, jumper 
configurations, programming considerations, and principles of operation of 
the iSBC 337 Numeric Data Processor. 

• iSBC 680/681 MULTISTORE USER SYSTEM PACKAGE HARDWARE 
REFERENCE MANUAL (Order Number: 162432) 

This manual provides chasis specifications and power supply and backplane 
servicing information. 
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SOFTWARE CONFIGURATION 



This chapter presents some detailed information about the preconfigured version 
of the iRMX 86 Operating System that accompanies the System 86/330A Micro- 
computer System. It provides this information for the following reasons: 

• To inform you of the directory structure and logical names assumed by the 
preconfigured version of the Operating System so that you can use this infor- 
mation when entering Human Interface commands. 



o 



To allow you to add features to the preconfigured Operating System, thus 
creating your own version of the Operating System. 



The first portion of this chapter assumes that you are familiar with the iRMX 86 hi- 
erarchical file structure and the Human Interface commands as they are described 
in the iRMX 86 HUMAN INTERFACE REFERENCE MANUAL. The latter por- 
tion of this chapter assumes you are familiar with software configuration as de- 
scribed in the iRMX 86 CONFIGURATION GUIDE. 



Bootstrap Loading 

Whenever you press the RESET button on the System 86/330A Microcomputer 
System, the system runs the System Confidence Test (SCT) and, if the SCT per- 
forms successfully, bootstrap loads the iRMX 86 Operating System into memory. 
In order to do this, the iRMX 86 Bootstrap Loader, which performs this loading 
process, makes an assumption about which file to load. It assumes that the file con- 
taining the Operating System resides on the Winchester disk and has the pathname 
SYSTEM/RMX86. If such a file does not exist, the Bootstrap Loader cannot auto- 
matically load the Operating System. 

There is also a mechanism that you can use to manually bootstrap load files into 
memory. You can use this mechanism under any of the following conditions: 

• If the Winchester disk does not contain a file whose pathname is 
SYSTEM/RMX86. 

• If the SCT fails and you still want to bootstrap load the Operating System 
(when the SCT fails, it transfers control to the iSBC 957B monitor without 
bootstrap loading the Operating System). 

o If you want to bootstrap load any file other than the preconfigured version of 
the Operating System (such as a customized version of the Operating System 
or a diagnostic program) . 



To perform this manual bootstrap loading process, you must press the INTRPT 
button to transfer control to the iSBC 957B monitor. Then you can use the B com- 
mand to bootstrap load any file you specify. For example, suppose you have confi- 
gured your own version of the Operating System and placed it in the file 
USER/PROG/MYSYS on the flexible disk drive. You can bootstrap load this file 
into the System 86/330A Microcomputer System by pressing the INTRPT button 
and entering the following command: 

.B :WF0:/USER/PROG/MYSYS 
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Notice that the format for specifying file names is slightly different than when 
using the Human Interface. The iSBC 957B device names are different and 
include: 



:WF0: Flexible disk drive 

:W0: Winchester disk drive 



You must also place a slash (/) between the device name and the beginning of the 
file name. 

The Bootstrap Loader is configured with :W0: as the default device and 
SYSTEM/RMX86 as the default file. Therefore, to bootstrap load the Operating 
System from the default file on the Winchester disk, you could enter the 
command: 



This command would load the file SYSTEM/RMX86 from the Winchester disk. 
To load a file other than SYSTEM/RMX86 from the Winchester disk (for 
example, the file USER/PROG/SYS2), you could enter the command: 



.B /USER/PROG/SYS2 



The device name is not required, but the initial slash is required. Refer to the 
iRMX 86 LOADER REFERENCE MANUAL for additional information on how 
to enter file names when communicating with the Bootstrap Loader. 

The System 86/330A Installation Diskette, which accompanies the system, con- 
tains two Operating System files which can be loaded by the Bootstrap Loader. 
These files have the pathnames SYSTEM/RMX86 and SYSTEM/RMX86.WD0. 

The first file, SYSTEM/RMX86, contains a preconfigured version of the Operat- 
ing System which assumes that a number of required directories and data files 
reside on the flexible disk. By interrupting into the monitor and bootstrap loading 
this file, you can bring up the Operating System before formatting the Winchester 
disk. You can then format the Winchester disk and install the files and directories 
onto it. A SUBMIT file on the installation diskette, USER/INSTALL.CSD per- 
forms this operation. Refer to the SYSTEM 86/330A INSTALLATION AND 
MAINTENANCE MANUAL for more information about using this file. 

The second file, SYSTEM/RMX86.WD0, is a preconfigured version which as- 
sumes that the required directories and data files reside on the Winchester disk. 
The SUBMIT file USER/INSTALL.CSD copies this file to the Winchester disk 
and gives it the pathname SYSTEM/RMX86. Later, when you press the RESET 
button, the Bootstrap Loader automatically loads the Operating System from this 
file. 
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Because the bootstrap load files are slightly different, you should remember that 
when you bootstrap load the system from the Winchester disk, the Operating 
System assumes that the Winchester disk is the system disk. And, when you 
bootstrap load the system from the Installation Diskette, the Operating System as- 
sumes that the flexible disk is the system disk. 



Directory Structure 

The preconfigured version of the iRMX 86 Operating System assumes that one of 
your secondary storage devices (the flexible disk or the Winchester disk) is the 
system disk (refer to the previous section for more information). When the 
Operating System starts running, it searches the system disk for certain directories 
and files. If these directories and files do not exist, the Operating System might not 
initialize itself correctly. The installation diskette, supplied as part of the System 
86/330A release materials, is set up with the correct directory structure. You 
should ensure that the Winchester disk also contains this directory structure so 
that you can use it as your system disk. (The SUBMIT file USER/INSTALL.CSD 
sets up the Winchester disk with the correct directories and copies a number of 
data files under these directories. (Refer to the SYSTEM 86/330A INSTALLA- 
TION AND MAINTENANCE MANUAL for more information.) Figure 6-1 illus- 
trates the directory structure assumed by the preconfigured version of the Operat- 
ing System. 




INSTALL. CSD LOGIN 



- DIRECTORY 




Figure 6-1. System 86/330A Directory Structure 



6-3 



Software Configuration System 86/330A 



As you can see from Figure 6-1, the Operating System assumes that your system 
disk contains five directories (other than the root directory of the volume, which 
is always present). On the installation diskette, these directories serve the follow- 
ing purposes: 



SYSTEM This directory contains all the Human Interface commands, the 
iRMX 86 interface libraries, and the bootstrap load file (named 
RMX86). 

LANG This directory contains the editor, the iRMX 86 language 

translators, and the language utilities. 

USER This is your default directory. Unless you specify otherwise, all 

directories and files that you create are listed in this directory. 
When you enter the DIR command without parameters, the 
Operating System displays the entries in the USER directory. 

PROG This is a directory under the USER directory which you can use to 

store your programs. 

WORK This is a directory under the USER directory which the language 

translators and utilities use to store temporary and work files. 



The directory USER contains two additional data files called INSTALL.CSD and 
LOGIN. INSTALL.CSD is a SUBMIT file which formats the Winchester disk and 
copies all the directories and data files from the installation diskette to the 
Winchester disk. You should submit INSTALL.CSD first to install your software 
on the Winchester disk. Refer to the SYSTEM 86/330A INSTALLATION AND 
MAINTENANCE MANUAL for more information. 

LOGIN is also a SUBMIT file. However, it is different from other SUBMIT files in 
that whenever you bootstrap load the Operating System, the Operating System au- 
tomatically submits the file LOGIN. Refer to the "LOGIN File" section of this 
chapter for more information. 

You can create as many additional directories and data files as you wish. However, 
the preconfigured version of the Operating System requires that the directories 
SYSTEM, LANG, USER, PROG, and WORK be present. If you reconfigure the 
Operating System, you can change this requirement. Refer to the iRMX 86 CON- 
FIGURATION GUIDE for more information. 



Logical Names 

During initialization, the iRMX 86 Operating System obtains connections to cer- 
tain devices and files and catalogs these connections as logical names. This makes 
using the Human Interface easier for the following reasons: 



• The Winchester and flexible disk devices are already attached. Thus, when 
you refer to these devices, you can use their logical names immediately, in- 
stead of having to enter the ATTACHDEVICE command to attach the 
devices. 
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Certain directories have logical names so that you can refer to them without 
having to enter their complete pathnames. 



The following sections discuss in more detail the logical names that the Operating 
System assigns. The sections divide the discussion into device logical names and 
directory logical names. 



Device Logical Names 

Table 6-1 lists the logical names for the devices that the preconfigured version of 
the Operating System assigns during its initialization. It also lists their physical 
names and their characteristics. 

You can use the logical names listed in Table 6-1 when you enter Human Interface 
commands. For example, if you want to display the root directory of a volume in 
the flexible disk drive, you can enter the following command: 



-DIR :FD0: 



The Operating System then lists files in the directory. 



Table 6-1. Logical Names of Devices 



Logical Name 


Device 


Physical Name 


Characteristics 


:WDO: 


Winchester 
disk 


IWO 


1024-byte device 
granularity 


:FDO: 


Flexible 

disk 


WFDDO 


double-sided, 
double-density, 256-byte 
device granularity 


:LP: 


Line printer 


LP 


Centronics-compatible 
line printer interface; do 
not use unless printer is 
connected 


:CI: 


Console input 


TO 




:CO: 


Console output 


TO 





As you can see from Table 6-1, the Operating System establishes a logical name 
for a line printer, even if you do not have a line printer connected to your system. 
However, you must not use :LP: as a logical name in any Human Interface com- 
mand unless you actually have a line printer connected to the system. Any attempt 
to do so causes the system to hang, requiring you to reinitialize the system by 
pressing the RESET button. 
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The physical names listed in Table 6-1 are actually the names of blocks of informa- 
tion called device unit information blocks (or DUIBs) which are set up during the 
configuration of the Basic I/O System. These DUIBs describe the devices to the 
Basic I/O System, so that the Basic I/O System knows how to communicate with 
the devices. The preconfigured version of the Operating System contains several 
DUIBs, some of which describe the same device but in slightly different manners. 
(For example, one DUIB for the flexible disk drive may assume that the drive con- 
tains a double-sided, double-density diskette and another DUIB for the same 
device may assume that the drive contains a single-sided, single-density diskette.) 
During initialization, the Operating System attaches the devices based on informa- 
tion supplied to it in configuration parameters. A parameter for each device speci- 
fies the physical name of the device (DUIB name). This tells the Operating 
System which one of several possible DUIBs to use. 

After system initialization, you can change the characteristics of the flexible disk 
drive, assign different logical names, or attach new devices to the system. You can 
change the characteristics of the flexible disk drive or assign a different logical 
name to any device by first using the DETACHDEVICE command to detach the 
device. Then you can use the ATTACHDEVICE command to reattach^the device 
with either a different physical name or a different logical name. This allows you to 
change the characteristics of the device or change its logical name without having 
to reconfigure the entire system. For example, suppose you wanted to use a single- 
density diskette with 128-byte granularity in your flexible disk drive. To do this 
you would have to enter the following commands: 



-DETACHDEVICE :FD0: 



:FD0:, detached 

- ATTACHDEVICE WFO AS :FD0: 
WFO attached as :FD0: 



These two commands tell the Operating System first to break the connection to 
the device and then to reestablish the connection assuming the characteristics 
listed in the DUIB named WFO. WFO is a physical name for a single-density drive 
with 128-byte granularity. 

To attach a new device to the system, you would enter just the ATTACHDEVICE 
command. For example, if you connected an additional flexible disk drive to your 
system, you could attach it by entering the following command: 

- ATTACHDEVICE WFD1 AS:FD1: 
WFD1 attached as :FD1: 



Table 6-2 lists the physical names available for use in the preconfigured version of 
the Operating System. This table also lists the characteristics associated with these 
physical names. Refer to the iRMX 86 HUMAN INTERFACE REFERENCE 
MANUAL for more information about ATTACHDEVICE and DETACHDEVICE. 



If you configure your own version of the Operating System, you can add DUIBs, 
thereby allowing you to support different devices, different characteristics with the 
same devices, and additional units. Refer to the iRMX 86 CONFIGURATION 
GUIDE for more information. 
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Table 6-2. Physical Device Names 



Physical 
Name 


Device 


Characteristics 


WFO 


Flexible disk 


Single-sided, single-density, 
1 28-byte granularity, unit 


WF1 


Flexible disk 


Single-sided, single-density, 
1 28-byte granularity, unit 1 


WFDO 


Flexible disk 


Single-sided, double-density, 
256-byte granularity, unit 


WFD1 


Flexible disk 


Single-sided, double-density, 
256-byte granularity, unit 1 


WFDDO 


Flexible disk 


Double-sided, double-density, 
256-byte granularity, unit 


WFDD1 


Flexible disk 


Double-sided, double-density, 
256-byte granularity, unit 1 


IWO 


Winchester disk 


1024-byte granularity, unitO 


IW1 


Winchester disk 


1024-byte granularity, unit 1 


TO 


Terminal 




LP 


Line printer 




STREAM 


Stream file device 




BB 


Byte bucket 





Directory Logical Names 

In addition to assigning logical names to devices, the Operating System assigns log- 
ical names to several directories. This allows you to refer to the directories by their 
logical names, instead of having to specify their entire pathnames. Table 6-3 lists 
the logical names that the preconfigured version of the Operating System assigns. 
It also lists the pathnames that correspond to these logical names. All pathnames 
listed in Table 6-3 are assumed to reside on the system disk. 

Table 6-3. Directory Logical Names 



Logical 
Name 


Corresponding 
Pathename 


Description 


:SYSTEM: 

:$: 

PROG: 
:WORK: 


SYSTEM 

USER 

USER/PROG 
USER/WORK 


Directory containing Human 
Interface commands, iRMX 86 
interface libraries, and 
bootstrap load file. 

Default directory that the 
Operating System assumes 
when you omit the beginning 
portion of a pathname. 

Directory which you can use to 
store your own programs. 

Directory which the language 
translators and utilities use to 
store temporary and work files. 
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Accessing Directories 

Once you initialize the Operating System, you can enter Human Interface com- 
mands to manipulate and examine data files and directories. In order to do this 
effectively, you should know which directory is your default directory and how to 
access other directories. 

The preconfigured version of the Operating System assigns the directory USER as 
your default directory. Refer to Figure 6-1 to see where this directory fits in the 
overall directory structure of the system disk. When you enter a file name at the 
system console and do not explicitly specify a directory with that file, the Operating 
System assumes that the file resides in directory USER. For example, if you enter 
the command: 



DIR 



the Operating System displays a listing of the directory USER. You could also 
obtain the same results by entering the following command: 



DIR :$: 



The logical name :$: also refers to your default directory. 

However, if you want a listing of one of the directories on the same hierarchical 
level as USER, such as SYSTEM or LANG (refer to Figure 6-1), you cannot 
simply enter a command such as: 



DIR SYSTEM (incorrect entry) 

This command would attempt to list a directory called SYSTEM that resides in 
your default directory (that is, a directory whose pathname is USER/SYSTEM). 
Instead, to obtain a listing of the directory SYSTEM, you should enter: 

DIR :SYSTEM: 

The DIR :SYSTEM: command lists the directory corresponding to the logical 
name :SYSTEM:. Since the logical name :SYSTEM: corresponds to the directory 
SYSTEM, this command obtains the desired results. 

If another directory (DIR2 for example) is on the same hierarchical level as 
USER, you can obtain a listing of this dirctory by entering: 

DIRfDIR2 



The up arrow or circumflex preceding DIR2 means that the Operating System, 
when searching for the directory, goes up one level in the file tree and then 
searches for directory DIR2. 
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Directory Search 

When you invoke any program from the Human Interface, whether it be a Human 
Interface command, a language product such as a compiler, or a program that you 
have written, you invoke the program by entering the name of the file that con- 
tains the program. If you specify the complete pathname of the program, the 
Operating System obtains the program from the device and directory that you 
specify and loads and executes the program. If the pathname you specify does not 
exist, the Operating System returns an error message. However, if you specify just 
the last component of the program's pathname, the Operating System searches 
several directories for the program. It does not return an error message until it has 
searched each of the directories. The directories that the preconfigured version of 
the Operating System searches, in order, are as follows: 



:$: Default Directory 

:PROG: Program Directory 

:SYSTEM: System Directory 

/LANG Languages Directory. The Operating System 

searches :WD0:LANG if your system disk is the 
Winchester, and :FD0:LANG if your system 
disk is the flexible disk. 



Therefore, if you create a program called myprog in the :PROG: directory, you can 
invoke that program by entering one of the following: 



myprog 

:PROG: myprog 

:WD0:USER/PROG/myprog 



The last two methods of invoking the program are unnecessarily long, because the 
Operating System automatically searches the :PROG: directory for the program. In 
the same manner, you can invoke all the Human Interface commands and the 
iRMX 86 language products without specifying their complete pathnames; they 
also reside in directories that the Operating System automatically searches. 

You can take advantage of the fact that the Operating System searches directories 
in a particular order. For example, suppose you write your own copy command, 
one that provides more or different functions than the Human Interface COPY 
command. If you want to invoke your own program whenever you type the com- 
mand "COPY", you can simply place your copy program in a file called COPY in 
the :PROG: directory. Then, when you enter the command "COPY", the Operat- 
ing System will invoke your copy program instead of the Human Interface COPY 
command. It does this because it searches the :PROG: directory before it searches 
the :SYSTEM: directory; thus it finds your program first and executes that 
program. 



If you still want to be able to invoke the Human Interface COPY command, you 
can do so by entering the complete pathname, that is, by entering one of the 
following: 

:WDO:SYSTEM/copy 
:SYSTEM:copy 
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LOGIN File 

Whenever the preconfigured version of the Operating System starts running, it au- 
tomatically invokes a SUBMIT file called LOGIN, which resides in the directory 
USER. As released, this SUBMIT file contains the following commands: 

DATE 
TIME 

When you bootstrap load the Operating System, it displays a sign-on message and 
then runs the SUBMIT file LOGIN. The following lines are displayed at the 
system console: 

SYSTEM 86/330 Vx.x : user = WORLD 

-DATE 

DATE: 01 JAN 78 

-TIME 

TIME: 00:00:00 

-END SUBMIT LOGIN 

This SUBMIT file reminds you to use the DATE and TIME Human Interface com- 
mands to set the system date and time. Otherwise, the Operating System assumes 
the system date and time to be the values listed in the display. You should always 
set the date and time when restarting the system to permit the system to record 
accurate creation and access dates for any files you create or access. The creation 
and access dates can be important if you use the BACKUP and RESTORE Human 
Interface commands. (Refer to the iRMX 86 HUMAN INTERFACE REFER- 
ENCE MANUAL for information about the BACKUP and RESTORE 
commands.) The System Analysis Test (SAT) also requires accurate values for 
the date and time. 

By using the editor, you can modify the LOGIN file to contain other commands 
you want the Operating System to invoke. Then whenever you bootstrap load the 
Operating System, the commands in this file will be invoked. 

The Bad Blocks Utility 

The Bad Blocks utility is a software tool that accepts bad-block information from 
you and modifies the Winchester disk's volume free space map to exclude these 
blocks from use. You can invoke this utility from the terminal or you can edit the 
SUBMIT file INSTALL.CSD to include the invocation. See the SYSTEM 
86/330A INSTALLATION AND MAINTENANCE MANUAL to learn how to 
include the Bad Blocks utility in your INSTALL.CSD file. 



(caution 1 



You should run this utility before you add other files to the 
Winchester. If you add other files to the Winchester before you 
run the utility, these files could be allocated to a- bad-block area 
on the disk. 



To invoke the utility from the terminal, place the installation diskette in the flexi- 
ble disk drive and enter the following command: 

:FD0:BADBLOCKS 
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The utility signs on with the following message and question: 

SYSTEM 86/330 BAD BLOCKS UTILITY, Vx.x 

Do you want to change the interleave factor? 

The interleave factor is the number of physical sectors between two logical sectors. 
The Bad Blocks utility assumes a default interleave factor of 4. If you are using the 
Bad Blocks utility with a Winchester disk which is formatted with a different inter- 
leave factor, answer YES. Otherwise, answer NO. If you answer NO, the utility 
skips the next response. If you answered YES, the utility responds as follows: 

Enter interleave value: 

After you enter the interleave value, the utility responds with: 

BAD BLOCKS? 

If you want to enter bad blocks information, enter YES. If you want to exit the 
utility, enter NO. If you entered YES, the utility begins asking for the bad blocks 
information as follows: 

Cylinder Number: 
Head Number: 
Byte Offset: 

To specify the cylinder number, head number, and byte offset, you must examine 
the sticker attached to the Winchester disk. See the SYSTEM 86/330A INSTAL- 
LATION AND MAINTENANCE MANUAL for instructions on removing the 
top cover of the System 86/330A Microcomputer System. Enter the data as speci- 
fied on the sticker. If the sticker contains track information rather than the byte 
offsets, enter TRACK as your response to the byte offset. After you specify the 
previous information, the utility responds as follows: 

MORE BAD BLOCKS? 
Enter YES to continue or NO to exit the utility. 



NOTE 



If you run DISKVERIFY after running the Bad Blocks utility, it 
will indicate that you have blocks "allocated but not referenced." 
These blocks correspond to the bad blocks you specified with the 
Bad Blocks utility. However, DISKVERIFY lists these blocks in a 
different format than the Bad Blocks utility. 

Also, you should not use the SAVE command in DISKVERIFY. 
The SAVE command destroys the bad block information. 



Configuring Your Own Version of the Operating 
System 

The System 86/330A Microcomputer System includes special System 86/330A 
configuration files as well as the release diskettes for all of the iRMX 86 products. 
The special System 86/330A configuration files, which produce the preconfigured 
operating system, are contained on the configuration diskette. By using these files 
as a basis for your configuration, you obtain all the features of the preconfigured 
operating system. You can then modify these files to add new features. 
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In addition to the special System 86/330A configuration files, the configuration 
diskette contains the iRMX 86 Interface Libraries and their INCLUDE files the 
^'versal Development Interface (UDI) libraries and their INCLUDE files 'and 
the 8087 Numeric Support Libraries. You will need the libraries and INCLUDE 
tiles lor the development and implementation of PL/M-86 and ASM86 programs. 

The configuration diskette contains the following four directories: 



• RMX 



This directory contains the special System 86/330A 
configuration files that you can use to produce a 
system that is exactly like the preconfigured version of 
the Operating System. 



• RMXLIB 



This directory contains the iRMX 86 Interface Li- 
braries and the UDI libraries. 



• RMXINC 



This directory contains the INCLUDE files that you 
need in order to make system calls and interpret the 
status returned from system calls. 



NDPLIB 



This directory contains the 8087 Numeric Support 
Libraries. For more information, see the 8087 
NUMERIC SUPPORT LIBRARIES REFERENCE 
MANUAL. 



Installing The Directories on Your Winchester 

&£ r , d « r t0 inSta11 the special Svstem 86/330A configuration files on your System 
86/330A, you must use the following SUBMIT files: 



INSTALLSUPPORT 



This SUBMIT file creates the directories 
"RMXLIB", "RMXINC", and "NDPLIB" on 
the Winchester disk immediately under the root 
directory. It then installs the libraries and include 
files in the appropriate directories. 



• INSTALLRMX 



This SUBMIT file installs the directory "RMX" 
on the Winchester disk immediately under the 
root directory. It then installs the special System 
86/330A configuration files in the appropriate 
directories. 



Assuming that you have installed your system on the Winchester disk place the 
configuration diskette into the flexible disk drive. Enter the following commands 
to create the directories and to install the libraries and INCLUDE files in these 
directories. 

- DETACHDEVICE :FD0: 

:FD0:, detached 

- ATTACHDEVICE WFDO AS :FD0: 

WFDO attached as :FD0: 

-SUBMIT :FD0:INSTALLSUPPORT 
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The immediately-preceding command creates the following directories: 

:WDO:RMXLIB 

:WDO:RMXINC 

:WDO:NDPLIB 

and installs the support libraries and INCLUDE files in the appropriate directories. 

Enter the following command to build the RMX directory structure and to transfer 
the special System 86/330A configuration files to their appropriate directories. 

- SUBMIT :FDO:INSTALLRMX 
The previous command builds the following directories: 

:WDO:RMX/DNUCLUS (Nucleus) 
:WD0:RMX/DBIOS (Basic I/O System) 
:WD0:RMX/DEIOS (Extended I/O System) 
:WD0:RMX/DLOADER (Application Loader) 
:WDO:RMX/DHI (Human Interface) 
:WDO:RMX/DSDB (System Debug Monitor) 

and installs the special System 86/330A configuration files in the appropriate 
directories. The previous directories now contain the special System 86/330A con- 
figuration files that correspond to the System 86/330A versions of the iRMX 86 
layers. For example, :WD0:RMX/DEIOS contains all of the special System 
86/330A configuration files associated with the Extended I/O System. 



Altering Special 86/330A Configuration Files and Adding 
Features To The Operating System 

After you install the special System 86/330A configuration files, you can begin al- 
tering them or adding features to create your own version of the Operating 
System. You should use the iRMX 86 CONFIGURATION GUIDE as your pri- 
mary source of information about altering the special System 86/330A configura- 
tion files and adding features to the Operating System. 

The special System 86/330A configuration files you added to the Winchester disk 
are System 86/330A versions of the iRMX 86 Configuration files. Their functions 
are similar to those of the comparable iRMX 86 files. However the System 
86/330A files have slightly different naming conventions as follows: 



• 



The special System 86/330A configuration files use "330" as the last charac- 
ters in the name before the extension. So, for example, NTABLE330.A86 
corresponds to the Nucleus configuration file, NTABLE.A86. 

Some of the parameters in the special System 86/330A configuration files 
have different values than the defaults described in the iRMX 86 CON- 
FIGURATION GUIDE. Examine the configuration files to find the dif- 
ferences in the default values, and then alter files as necessary to create your 
version of the Operating System. 
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Including and Modifying Standard iRMX 86 Configuration 
Files 

If you want to include features of the iRMX 86 Operating System that are not in 
the standard System 86/330A files, you must first obtain the standard files from 
the iRMX 86 release diskettes and modify them so they can be used on the System 
86/330. To make the process of modifying additional iRMX 86 configuration files 
on the System 86/330A Microcomputer System easier, you should copy the files 
you want from the iRMX 86 release diskettes to the Winchester disk before start- 
ing the configuration process. Since this may add a considerable number of files to 
the Winchester disk, you should take advantage of the hierarchical structure of 
iRMX 86 files by placing the names of files in the existing directories described in 
the previous sections. Placing the names of the files in the existing directories 
helps you to organize the large number of files. You may also have to create some 
new directories to contain some of these files. For example, suppose you wanted 
to use the iRMX 86 Debugger in your system. You should create a new directory 
called RMX/DTHDB and copy the files from the Terminal Handler and Debugger 
release diskette to it. 

Each iRMX 86 release diskette contains one or more configuration files (with 
names ending in ".P86" or ".A86") and one or more SUBMIT files (with names 
ending in ".CSD"). These files contain INCLUDE statements or commands that 
make direct reference to other files. These statements and commands use the 
terms :F0:, :F1:, :F2:, and :F3: to refer to the drives on which the diskettes are 
mounted. The iRMX 86 CONFIGURATION GUIDE discusses the drive conven- 
tions assumed by the release diskettes. 

Although the drive conventions are useful when performing the configuration pro- 
cess on a system with four flexible disk drives, they do not permit you to perform 
the configuration process on the System 86/330A Microcomputer System. So, 
before you can perform the configuration, you must make modifications to the 
configuration and SUBMIT files. 

To make the necessary changes, examine all files whose names end with the char- 
acters ".P86", ".A86", and ".CSD". In each of these files, look for references to 
:F0:, :F1:, :F2:, and :F3:. You must change each of these terms to the appropriate 
combination of logical name and directory names to reflect the actual pathname of 
the file. 

For example, as released, one of the Terminal Handler configuration files, 
MCONFG.A86, contains the statement: 



$INCLUDE(:F2:MTHCNF.MAC) 



If you created a directory (called /RMX/DTHDB in this example) to contain the 
iRMX 86 Terminal Handler and copied the release diskette to the Winchester disk 
as recommended in this section, you must modify the INCLUDE statement to 
read: 



$INCLUDE(/RMX/DTHDB/MTHCNF.MAC) 
You must make similar changes for all references to :F0:, :F1:, :F2:. and :F3:. 
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When you installed the SUBMIT file, INSTALLRMX, you included another 
SUBMIT file, SGEN330.CSD, on your Winchester disk. This file contains the 
commands you need in order to generate your own bootstrap loadable version of 
the operating system. If you are using only the special System 86/330A configura- 
tion files, you can use this SUBMIT file as it is. However, if you use any iRMX 86 
configuration files not included in the configuration of the preconfigured system, 
you may have to modify SGEN330.CSD. In any case, examine the SUBMIT file to 
be sure that it contains the configuration invocation commands that you need. 

The following examples show how to use the SUBMIT file to create a system 
which uses the Winchester as the system disk or a system that uses the flexible 
disk drive as the system disk drive. 

If you want your system to use the Winchester as its system disk, enter the follow- 
ing SUBMIT command. 

- SUBMIT /RMX/SGEN330.CSD(date,WD0) OVER /RMX/SGENWDO.LST 

where "date" is the current date in the format mm/dd/yy. The previous command 
configures the Operating System from the set of configuration files listed in the 
SUBMIT file and generates a bootstrap loadable version of the Operating System 
on file, /RMX/RMX86.WD0. This command also creates a listing file, 
SGENWDO.LST that records the results of the SUBMIT file. 

If you want your system to use the flexible disk as its system disk drive, enter the 
following SUBMIT command. 

- SUBMIT /RMX/SGEN330.CSD(date,FD0) OVER /RMX/SGENFDO.LST 

where "date" is the current date in the format mm/dd/yy. The previous command 
configures the Operating System from the set of configuration files listed in the 
SUBMIT file and generates a bootstrap loadable version of the Operating System 
on file, /RMX/RMX86.FD0. This command also creates a listing file, 
SGENFDO.LST that records the results of the SUBMIT file. 
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